home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / storex47.zip / STOREX.DOC < prev    next >
Text File  |  1993-03-22  |  18KB  |  362 lines
  1.  
  2.          One of The Livewire BBS PCBoard(TM) multi-BBS Doorware programs.
  3.                   Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS,
  4.                     Remote Access, SpitFire, WWIV and others.
  5.  
  6.                                       By
  7.                                 Richard Paquette
  8.                                    PO Box 416
  9.                               Mt. Laurel, NJ 08054
  10.  
  11.                                (C) Copyright 1992
  12.                                All Rights Reserved
  13.  
  14.                                 DOOR DESCRIPTION!
  15.  
  16. This door allows the sysop to establish a shopping center environment
  17. for his/her bbs. This door will allow up to 54 Departments when registered and
  18. only 3 while being used for evaluation purposes.
  19.  
  20. The first screen to be seen (if exist) is a welcome screen, this MUST
  21. be called STOREX.SCR. It can be edited with most any ansi/ascii program. If
  22. you use THEDRAW, please save it with a ALT-B option at maximum 18 lines. It
  23. will display much faster and complete this way. Other programs we aren't sure
  24. about.. let us know!
  25.  
  26. The next screen shown will be the Main Department Selection Screen, if
  27. you have more than 27 departments, there will be a prompt such as:
  28.  
  29.                  FIRST FLOOR [CR] = Second Floor Departments
  30.                   " Press ENTER to continue or E to exit "
  31.  
  32. If they hit [CR] then the next floor will be displayed in much the
  33. same way saying:
  34.  
  35.         SECOND FLOOR [CR] = First Floor Departments
  36.     
  37. But on this floor they will be prompted for the department they wish
  38. to visit. If a [CR] is hit, then they will be brought back to the FIRST FLOOR
  39. automatically at which time the first prompt will be shown again, if they hit
  40. E to exit, then they will be prompted for the department they wish to visit.
  41.  
  42. If they enter a department number above your last department, they will
  43. be told "NO SUCH DEPARTMENT" and the prompt will return. If they select any
  44. department and LIVESTORE CANNOT find the display file, they will be prompted
  45.  "File not found, Please notify your Sysop!". Hopefully, they will leave you
  46. a comment so that the problem can be fixed.
  47.  
  48. When viewing a department screen, the prompt bar will have always have
  49. the following options:
  50.  
  51.       [O]=Order  [S]=Search  [M]=Menu  [Q]=Quit to BBS  [CR]=Continue
  52.  
  53. If the O option is selected, they will be prompted for all the info-
  54. mation we need to create an order file for you called (orders.yes) in the
  55. program directory. At almost every prompt, they have the option to [Q] the
  56. order.. this WILL NOT write and orders.yes file. They will simply be brought
  57. back to the Main Department Menu.
  58.  
  59. If they select the S option, they will be prompted whether they would
  60. like it displayed [1]=One line at the time or [2]=Full page display. Then they
  61. are prompted for the "keyword" to search.. if none is found, they are brought
  62. back to the Main Department Menu. Of course if the "keyword" is found, it will
  63. be displayed in whichever manner they selected. (I hope)
  64.  
  65. If they select the M option, they are brought back to the Main Menu.
  66.  
  67. If they select the Q option, they are brought back to the BBS Menu.
  68.  
  69. If they hit [CR] then the department file continues to display with
  70. the prompt line always there giving them all the options at any time.
  71.  
  72. Well, that is about it for the screens. Of course if any of the files
  73. needed for display in a department aren't there.. then they will have a hard
  74. time to order anything! <GR>
  75.  
  76. IMPORTANT NOTE FOR NON STANDARD IRQ's:
  77.  
  78.                   Supports COM 0 to 15 on the standard IRQ's
  79.                     Com1/Com3 = IRQ4 and Com2/Com4 = IRQ3
  80.  
  81.                You can make use of the IRQ environment variable
  82.  
  83. If you wish to use a non-standard IRQ, add the IRQ number after the 
  84. configuration filename. For example the program is STOREX and you want to use 
  85. Com1 and IRQ5. The command line passed to your door would be:
  86.  
  87.                           STOREX STOREX.CFG /5 
  88.  
  89.                                   or
  90.  
  91.           STOREX STOREX.CFG /%IRQ% using the environment variable
  92.  
  93. The /5 tells STOREX to use IRQ5 rather than the standard IRQ4 that is
  94. normally used with COM1. No /x parameter is needed for the standard IRQ's.
  95.  
  96. IMPORTANT NOTE FOR FOSSIL DRIVER USERS:
  97.  
  98.  LiveStore now includes support for FOSSIL drivers!!! This means your Doors
  99.  will work with Digiboard (e.g. Wildcat!'s M version) and other multi-port
  100.  boards. To activate the Fossil driver support, just include /FD on the
  101.  command line when running the Door. For example:
  102.  
  103.       STOREX STOREX.CFG /FD
  104.  
  105.  If no Fossil driver is available, LiveStore will display a message to that
  106.  effect and exit gracefully.
  107.  
  108.                                  FILES
  109.  
  110.              The following files are packaged with STOREX40.ZIP
  111.  
  112.  Storex.exe   <--- executable program (MUST BE IN DIRECTORY)
  113.  Storex.cfg   <--- sample configuration file (MUST BE IN DIRECTORY)
  114.  Storex.ndx   <--- file names for each department (MUST BE IN DIRECTORY)
  115.  Storex.doc   <--- You are reading it right now
  116.  Storex.new   <--- explains whatsnew with each version
  117.      *x.txt   <--- All the same files renamed for Samples ONLY!
  118.  Storex.scr   <--- Welcome screen that MUST be remain named STOREX.SCR
  119.  Strutil.exe  <--- Utility to create txt files
  120.  Strutil.doc  <--- Docs for Strutil.exe program
  121.  Storex.log * <--- program will create and append with each visitor
  122.  Storex.ord * <--- created when an order is placed from any department
  123.                   and appended if not deleted.
  124.  
  125.                    EXPLANATION OF STOREX.CFG FILE NEEDED
  126.  
  127.     %PCBDRIVE%%PCBDIR%\USERS.SYS <-- Using environment variables for path
  128.     The Livewire BBS             <-- Your BBS Name
  129.     Richard                      <-- Your First Name
  130.     Paquette                     <-- Your Last Name
  131.     99999                        <-- Registration # (something MUST be here)
  132.     Callers Digest, Inc.         <-- Your company or BBS name displayed on Menu
  133.     YES                          <-- Allow shipping prompts (YES or NO)
  134.     YES                          <-- Accept Credit Cards (YES or NO)
  135.     VMDA                         <-- Visa, Mastercard, Discover, American Ex
  136.     NJ625  (Means 6.25% etc.)    <-- Your STATE and your STATE TAX
  137.     9                            <-- Number of Departments (SEE NOTE BELOW)
  138.     Add-On Cards                 <-- Name of department (20 character MAX)
  139.     USR Modems                   <-- Name of department 
  140.     VGA Monitors                 <-- Name of department
  141.     Artisoft Lantastic           <-- Name of department
  142.     Mother-Boards                <-- Name of department
  143.     Keyboards                    <-- Name of department
  144.     Entire Systems               <-- Name of department
  145.     Floppy Drives                <-- Name of department
  146.     Hard Drives                  <-- Name of department
  147.         
  148. NOTE: If you are haven't registered LIVESTORE, then any number you
  149. enter here over 3 will NOT be displayed.. an UNREGISTERED version can only
  150. handle 3 departments.. so it will overlook any department names after the
  151. third one!
  152.  
  153.                    EXPLANATION OF STOREX.NDX FILE NEEDED
  154.     
  155. EACH of these files MUST be made up by YOU.. We have no outlets for 
  156. any products whatsoever. The products and txt file to display are all your
  157. responsibility. PLEASE do not call us for products or text files.. we have
  158. none.. the text files shown in our copy of STOREX on The Livewire BBS are for
  159. display sample ONLY!
  160.  
  161.     systemsx.txt   <-- sample random file created with strutil.exe
  162.     monix.txt      <-- sample also
  163.     modemx.txt     <-- sample also
  164.     
  165.            NOTE: these files MUST BE in the same directory
  166.                  that the door is being run from, for example:
  167.                  if you have c:\pcb\storex then all go in storex dir.
  168.  
  169. If you have any other suggestions to improve this program and/or have
  170. problems, please call us at THE LIVEWIRE BBS (number at bottom) and leave us
  171. a C)omment explaining in detail what happened, leave us a voice number and we
  172. will be glad to call you back to help with the setup and/or fix the problem.
  173.  
  174. The following are examples for the first FOUR lines only, you must
  175. read the above for the proper configuration file after the top FOUR lines!
  176.  
  177.                         Example configuration files
  178.                         ---------------------------
  179.                                                                              
  180. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  181. The Livewire BBS    <=-  (Change this to your BBS name)
  182. Richard             <=-  (The Sysop's first name)
  183. Paquette            <=-  (The Sysop's last name)
  184.  
  185.                                                                              
  186. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  187. The Livewire BBS    <=-  (Change this to your BBS name)
  188. Richard             <=-  (The Sysop's first name)
  189. Paquette            <=-  (The Sysop's last name)
  190.  
  191.                                                                              
  192. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  193. The Livewire BBS    <=-  (Change this to your BBS name)
  194. Richard             <=-  (The Sysop's first name)
  195. Paquette            <=-  (The Sysop's last name)
  196.  
  197.                                                                              
  198. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  199. The Livewire BBS    <=-  (Change this to your BBS name)
  200. Richard             <=-  (The Sysop's first name)
  201. Paquette            <=-  (The Sysop's last name)
  202. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  203.  
  204.                                                                              
  205. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  206. The Livewire BBS    <=-  (Change this to your BBS name)
  207. Richard             <=-  (The Sysop's first name)
  208. Paquette            <=-  (The Sysop's last name)
  209.  
  210.                                                                              
  211. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  212.                           where 'x' is the BBS Node number.
  213. The Livewire BBS    <=-  (Change this to your BBS name)
  214. Richard             <=-  (The Sysop's first name)
  215. Paquette            <=-  (The Sysop's last name)
  216.  
  217.                                                                              
  218. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  219. The Livewire BBS    <=-  (Change this to your BBS name)
  220. Richard             <=-  (The Sysop's first name)
  221. Paquette            <=-  (The Sysop's last name)
  222.  
  223.                                                                              
  224. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  225. The Livewire BBS    <=-  (Change this to your BBS name)
  226. Richard             <=-  (The Sysop's first name)
  227. Paquette            <=-  (The Sysop's last name)
  228.  
  229.                                                                              
  230. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  231. The Livewire BBS    <=-  (Change this to your BBS name)
  232. Richard             <=-  (The Sysop's first name)
  233. Paquette            <=-  (The Sysop's last name)
  234. 1                   <=-  (COM port number - defaults to 1)
  235. 1                   <=-  (Node number - defaults to 1)
  236. 123123              <=-  (Registration Number)
  237.  
  238.                                                                              
  239. C:\BBS\TRIBBS.SYS   <=-  (Full pathname of your TRIBBS.SYS file)
  240. The Livewire BBS    <=-  (Change this to your BBS name)
  241. Richard             <=-  (The Sysop's first name)
  242. Paquette            <=-  (The Sysop's last name)
  243.  
  244.                                  ==============
  245.  
  246.                                 STOREX BATCH FILE
  247.  
  248. This is the batch file whose name is entered in your SETUP. It should reside in
  249. your default directory. Leave this as is except for changing the paths.
  250.  
  251.   @ECHO OFF          <-- optional
  252.   E:\                <-- start batch at root directory of door directory
  253.   CD\STOREX          <-- change to door directory
  254.   SET PCBDRIVE=C:    <-- for NON PCBoard BBS's where your system dir is
  255.   SET PCBDIR =\BBS   <-- for NON PCBoard BBS's where your system files are
  256.   STOREX STOREX.CFG  <-- Please read NOTE below
  257.   SET PCBDRIVE=      <-- Set variable to NULL
  258.   SET PCBDIR=        <-- Set variable to NULL
  259.   C:\                <-- return to root
  260.   CD\BBS             <-- change to your bbs dir
  261.   BOARD              <-- run bbs file
  262.  
  263.   NOTE: By using the environment variables you need ONLY ONE CFG for each
  264.         node and saves from editing many CFG files. Our STRUTIL.EXE program
  265.         will default to editing the STOREX.CFG file anyway.. so you would
  266.         then need to rename each if you wanted to use many CFG files. We
  267.         strongly suggest using environment variables to ease operation.
  268.  
  269.   NOTE: There is NO need for seperate configuration files for each
  270.         node.. you can use the same STOREX.CFG for each node batch
  271.         file. If you have problems, please notify us as soon as you
  272.         can with copies of your batch file and config file.
  273.  
  274.                               Sysop Keys
  275.                               ----------
  276.  
  277. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  278.          written to DOOR.SYS and USERS.SYS
  279. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  280.          and/or written to DOOR.SYS and USERS.SYS
  281. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  282. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  283.          and/or written to DOOR.SYS and USERS.SYS
  284. F8    -  Returns the caller involuntarily to the BBS.
  285. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  286.          and/or written to DOOR.SYS and USERS.SYS
  287. F10   -  Activates SysOp CHAT mode within the DOOR.
  288. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  289. UP    -  Give the caller extra time while in the DOOR.  
  290. DN    -  Subtract time from the caller while in the DOOR. 
  291. HOME  -  HELP key for Status Line options.
  292. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  293. ALT-X -  PCBoard will exit after current caller logs off. Value is
  294.          passed to PCBoard. Not available on non-PCBoard systems.
  295.  
  296.                             WATCHDOG/CTTY/ANSI.SYS
  297.                             ----------------------
  298.  
  299.         CTTY and WATCHDOG are NOT required and should not be used with
  300.         this program.  STOREX contains its own communication routines
  301.         which monitor the COM port.  If carrier is lost, it will return
  302.         to the BBS where the BBS will log the user off the system.
  303.  
  304.         ANSI.SYS or something similar, is required for STOREX to function.
  305.  
  306.                                  DISTRIBUTION
  307.                                  ------------
  308.  
  309.         STOREX is COPYRIGHTED by Richard Paquette, with all rights reserved.
  310.         This program is being distributed via the SHAREWARE concept and as
  311.         such, may be copied freely with the following restrictions:
  312.  
  313.                 * The program must be supplied in it's original
  314.                   unmodified form, including documentation.
  315.  
  316.                 * STOREX may not be distributed as part of any
  317.                   commercial application or service without the
  318.                   express, written consent of the author.
  319.  
  320.                 * Vendors of Shareware/Public Domain software may
  321.                   not distribute this program without the express,
  322.                   written consent of the author.
  323.  
  324.                                  REGISTRATION
  325.                                  ------------
  326.  
  327.         STOREX represents many hours of programming and the author
  328.         deserves just compensation for his time, efforts and expertise.
  329.         If you find this program to be of some value and you continue
  330.         to use it on your BBS system, you must return the registration
  331.         form provided along with the registration fee. Registration
  332.         entitles you to free upgrades via modem from The Livewire's Support
  333.  
  334.            **********           REGISTER ONLINE          ***********
  335.  
  336.         You may also call The Livewire BBS and register online via
  337.         Visa or Mastercard using our online Credit Card door which will 
  338.         produce your registration number on the spot! At the main board
  339.         prompt just type  REGISTER  and presto.. 
  340.  
  341.         Suggestions and/or comments may be sent to the address below or
  342.         via electronic mail: 
  343.  
  344.         The executable has been compressed using PKLite and if you have
  345.         any problems.. please call The Livewire BBS and download an exe
  346.         that hasn't been compressed with PKLite.. We have NOT had any
  347.         problems but wanted to notify you the exe is available in its
  348.         raw state! <GR>
  349.  
  350.                    *** NET-HUB for RealLife(tm) Net ***
  351.                       Node ID is: LIVEWIRE for RIME
  352.                       Node ID is: LIVEWIRE for Intelec
  353.                       Node ID is: LIVEWIRE for AfterDark
  354.                       Node ID is: LIVEWIRE for SmartNet
  355.                       Node ID is: LIVEWIRE for ILink
  356.                         FidoNet Address:  1/266:36
  357.                        PoliceNet Address: 150/350:29
  358.                   InterNet Address: Richard.Paquette@bbscd.com
  359.  
  360.                     Public Access Node1: (609) 235-5297 HST
  361.                             ----------------------
  362.